home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 September / CHIP Eylül 1998.iso / Slackwar / docs / DNS-HOWTO < prev    next >
Text File  |  1997-03-24  |  68KB  |  1,618 lines
  1.   DNS HOWTO
  2.   Nicolai Langfeldt janl@math.uio.no
  3.   v2.0.3, 13 March 1998
  4.  
  5.   HOWTO become a totally small time DNS admin.
  6.  
  7.   1.  Preamble
  8.  
  9.   Keywords: DNS, bind, bind-4, bind-8, named, dialup, ppp, slip, isdn,
  10.   Internet, domain, name, hosts, resolving
  11.  
  12.   1.1.  Legal stuff
  13.  
  14.   (C)opyright 1995 Nicolai Langfeldt.  Do not modify without amending
  15.   copyright, distribute freely but retain copyright message.
  16.  
  17.   1.2.  Credits and request for help.
  18.  
  19.   I want to thank Arnt Gulbrandsen who read the drafts to this work
  20.   countless times and provided many useful suggestions.  I also want to
  21.   thank the people that have e-mailed suggestions and notes.
  22.  
  23.   This will never be a finished document, please send me mail about your
  24.   problems and successes, it can make this a better HOWTO.  So please
  25.   send money, comments and/or questions to janl@math.uio.no.  If you
  26.   send e-mail and want an answer please show the simple courtesy of
  27.   making sure that the return address is correct and working.  Also,
  28.   please read the ``FAQ'' section before mailing me.
  29.  
  30.   If you want to translate this HOWTO please notify me so I can keep
  31.   track of what languages I have been published in, and also I can
  32.   notify you when the HOWTO has been updated.
  33.  
  34.   1.3.  Dedication
  35.  
  36.   This HOWTO is dedicated to Anne Line Norheim Langfeldt.  Though she
  37.   will probably never read it since she's not that kind of girl.
  38.  
  39.   2.  Introduction.
  40.  
  41.   What this is and isn't.
  42.  
  43.   For starters, DNS is is the Domain Name System.  DNS converts machine
  44.   names to the IP numbers that are all the machines addresses, it maps
  45.   from name to address and from address to name.  This HOWTO documents
  46.   how to define such mappings using a Linux system.  A mapping i simply
  47.   a association between two things, in this case a machine name, like
  48.   ftp.linux.org, and the machines IP number, 199.249.150.4.
  49.  
  50.   DNS is, to the uninitiated (you ;-), one of the more opaque areas of
  51.   network administration.  This HOWTO will try to make a few things
  52.   clearer.  It describes how to set up a simple DNS name server.
  53.   Starting with a caching only server and going on to setting up a
  54.   primary DNS server for a domain.  For more complex setups you can
  55.   check the ``FAQ'' section of this document.  If it's not described
  56.   there you will need to read the Real Documentation.  I'll get back to
  57.   what this Real Documentation consists of in ``the last chapter''.
  58.  
  59.   Before you start on this you should configure your machine so that you
  60.   can telnet in and out of it, and make successfully make all kinds of
  61.   connections to the net, and you should especially be able to do telnet
  62.   127.0.0.1 and get your own machine (test it now!).  You also need a
  63.   good /etc/nsswitch.conf (or /etc/host.conf), /etc/resolv.conf and
  64.   /etc/hosts files as a starting point, since I will not explain their
  65.   function here.  If you don't already have all this set up and working
  66.   the NET-3 and or the PPP-HOWTO explains how to set it up.  Read it.
  67.  
  68.   When I say `your machine' I mean the machine you are trying to set up
  69.   DNS on.  Not any other machine you might have that's involved in your
  70.   networking effort.
  71.  
  72.   I assume you're not behind any kind of firewall that blocks name
  73.   queries.  If you are you will need a special configuration, see the
  74.   section on ``FAQ''.
  75.  
  76.   Name serving on Unix is done by a program called named.  This is a
  77.   part of the bind package which is coordinated by Paul Vixie for The
  78.   Internet Software Consortium.  Named is included in most Linux
  79.   distributions and is usually installed as /usr/sbin/named.  If you
  80.   have a named you can probably use it; if you don't have one you can
  81.   get a binary off a Linux ftp site, or get the latest and greatest
  82.   source from ftp.isc.org:/isc/bind/src/cur/bind-8/.  This HOWTO is
  83.   about bind version 8.  The old version of the HOWTO, about bind 4 is
  84.   still available at http://www.math.uio.no/~janl/DNS/ in case you use
  85.   bind 4.  If the named man page talks about named.conf you have bind 8,
  86.   if it talks about named.boot you have bind 4.  If you have 4 and are
  87.   security conscious you really ought to upgrade to a recent 8.
  88.  
  89.   DNS is a net-wide database.  Take care about what you put into it.  If
  90.   you put junk into it, you, and others will get junk out of it.  Keep
  91.   your DNS tidy and consistent and you will get good service from it.
  92.   Learn to use it, admin it, debug it and you will be another good admin
  93.   keeping the net from falling to it's knees overloaded by
  94.   mismanagement.
  95.  
  96.   In this document I state flatly a couple of things that are not
  97.   completely true (they are at least half truths though).  All in the
  98.   interest of simplification.  Things will (probably ;-) work if you
  99.   believe what I say.
  100.  
  101.   Tip: Make backup copies of all the files I instruct you to change if
  102.   you already have them, so if after going through this nothing works
  103.   you can get it back to your old, working state.
  104.  
  105.   3.  A caching only name server.
  106.  
  107.   A first stab at DNS config, very useful for dialup users.
  108.  
  109.   A caching only name server will find the answer to name queries and
  110.   remember the answer the next time you need it.  This will shorten the
  111.   waiting time the next time significantly, esp. if you're on a slow
  112.   connection.
  113.  
  114.   First you need a file called /etc/named.conf.  This is read when named
  115.   starts.  For now it should simply contain:
  116.   ______________________________________________________________________
  117.   // Config file for caching only name server
  118.  
  119.   options {
  120.           directory "/var/named";
  121.  
  122.           // Uncommenting this might help if you have to go through a
  123.           // firewall and things are not working out:
  124.  
  125.           // query-source address * port 53;
  126.   }
  127.  
  128.   zone "." {
  129.           type hint;
  130.           file "root.hints";
  131.   };
  132.  
  133.   zone "0.0.127.in-addr.arpa" {
  134.           type master;
  135.           file "pz/127.0.0";
  136.   };
  137.   ______________________________________________________________________
  138.  
  139.   The `directory' line tells named where to look for files.  All files
  140.   named subsequently will be relative to this.  Thus pz is a directory
  141.   under /var/named, i.e., /var/named/pz.  /var/named is the right
  142.   directory according to the Linux File system Standard.
  143.  
  144.   The file named /var/named/root.hints is named in this.
  145.   /var/named/root.hints should contain this:
  146.  
  147.   ______________________________________________________________________
  148.   \&.                       6D IN NS        G.ROOT-SERVERS.NET.
  149.   \&.                       6D IN NS        J.ROOT-SERVERS.NET.
  150.   \&.                       6D IN NS        K.ROOT-SERVERS.NET.
  151.   \&.                       6D IN NS        L.ROOT-SERVERS.NET.
  152.   \&.                       6D IN NS        M.ROOT-SERVERS.NET.
  153.   \&.                       6D IN NS        A.ROOT-SERVERS.NET.
  154.   \&.                       6D IN NS        H.ROOT-SERVERS.NET.
  155.   \&.                       6D IN NS        B.ROOT-SERVERS.NET.
  156.   \&.                       6D IN NS        C.ROOT-SERVERS.NET.
  157.   \&.                       6D IN NS        D.ROOT-SERVERS.NET.
  158.   \&.                       6D IN NS        E.ROOT-SERVERS.NET.
  159.   \&.                       6D IN NS        I.ROOT-SERVERS.NET.
  160.   \&.                       6D IN NS        F.ROOT-SERVERS.NET.
  161.  
  162.   G.ROOT-SERVERS.NET.     5w6d16h IN A    192.112.36.4
  163.   J.ROOT-SERVERS.NET.     5w6d16h IN A    198.41.0.10
  164.   K.ROOT-SERVERS.NET.     5w6d16h IN A    193.0.14.129
  165.   L.ROOT-SERVERS.NET.     5w6d16h IN A    198.32.64.12
  166.   M.ROOT-SERVERS.NET.     5w6d16h IN A    202.12.27.33
  167.   A.ROOT-SERVERS.NET.     5w6d16h IN A    198.41.0.4
  168.   H.ROOT-SERVERS.NET.     5w6d16h IN A    128.63.2.53
  169.   B.ROOT-SERVERS.NET.     5w6d16h IN A    128.9.0.107
  170.   C.ROOT-SERVERS.NET.     5w6d16h IN A    192.33.4.12
  171.   D.ROOT-SERVERS.NET.     5w6d16h IN A    128.8.10.90
  172.   E.ROOT-SERVERS.NET.     5w6d16h IN A    192.203.230.10
  173.   I.ROOT-SERVERS.NET.     5w6d16h IN A    192.36.148.17
  174.   F.ROOT-SERVERS.NET.     5w6d16h IN A    192.5.5.241
  175.   ______________________________________________________________________
  176.  
  177.   VERY IMPORTANT: In some versions of this document the file contents
  178.   listed here will have a couple of spaces or a tab before the first non
  179.   blank character. These are not supposed to be in the file.  Delete any
  180.   leading space in the files you cut and paste from this HOWTO.
  181.  
  182.   Remember what I said about leading spaces!
  183.  
  184.   The file describes the root name servers in the world.  This changes
  185.   over time and must be maintained.  See the ``maintenance section'' for
  186.   how to keep it up to date.
  187.  
  188.   The next line in named.conf is the primary line.  I will explain its
  189.   use in a later chapter, for now just make this a file named 127.0.0 in
  190.   the subdirectory pz:
  191.  
  192.   ______________________________________________________________________
  193.   @               IN      SOA     linux.bogus. hostmaster.linux.bogus. (
  194.                                   1       ; Serial
  195.                                   8H      ; Refresh
  196.                                   2H      ; Retry
  197.                                   1W      ; Expire
  198.                                   1D)     ; Minimum TTL
  199.                           NS      ns.linux.bogus.
  200.   1                       PTR     localhost.
  201.   ______________________________________________________________________
  202.  
  203.   Next, you need a /etc/resolv.conf looking something like this:
  204.  
  205.   ______________________________________________________________________
  206.   search subdomain.your-domain.edu your-domain.edu
  207.   nameserver 127.0.0.1
  208.   ______________________________________________________________________
  209.  
  210.   The `search' line specifies what domains should be searched for any
  211.   host names you want to connect to.  The `nameserver' line specifies
  212.   the address of your nameserver at, in this case your own machine since
  213.   that is where your named runs (127.0.0.1 is right, no matter if your
  214.   machine has an other address too).  If you want to list several name
  215.   servers put in one `nameserver' line for each. (Note: Named never
  216.   reads this file, the resolver that uses named does.)
  217.  
  218.   To illustrate what this file does: If a client tries to look up foo,
  219.   then foo.subdomain.your-domain.edu is tried first, then foo.your-
  220.   fomain.edu, finally foo.  If a client tries to look up
  221.   sunsite.unc.edu, sunsite.unc.edu.subdomain.your-domain.edu is tried
  222.   first (yes, it's silly, but that's the way it works) , then
  223.   sunsite.unc.edu.your-domain.edu, and finally sunsite.unc.edu.  You may
  224.   not want to put in too many domains in the search line, it takes time
  225.   to search them all.
  226.  
  227.   The example assumes you belong in the domain subdomain.your-
  228.   domain.edu, your machine then, is probably called your-
  229.   machine.subdomain.your-domain.edu.  The search line should not contain
  230.   your TLD (Top Level Domain, `edu' in this case).  If you frequently
  231.   need to connect to hosts in another domain you can add that domain to
  232.   the search line like this:
  233.  
  234.   ______________________________________________________________________
  235.   search subdomain.your-domain.edu your-domain.edu other-domain.com
  236.   ______________________________________________________________________
  237.  
  238.   and so on. Obviously you need to put real domain names in instead.
  239.   Please note the lack of periods at the end of the domain names.
  240.  
  241.   Next, depending on your libc version you either need to fix
  242.   /etc/nsswitch.conf or /etc/host.conf.  If you already have
  243.   nsswitch.conf that's what we'll fix, if not, we'll fix host.conf.
  244.  
  245.   /etc/nsswitch.conf
  246.  
  247.   This is a long file specifying where to get different kinds of data
  248.   types, from what file or database.  It usually contains helpful
  249.   comments at the top, which you should consider reading, now.  After
  250.   that find the line starting with `hosts:', it should read
  251.  
  252.   ______________________________________________________________________
  253.   hosts:      files dns
  254.   ______________________________________________________________________
  255.  
  256.   If there is no line starting with `hosts:' then put in the one above.
  257.   It says that programs should first look in the /etc/hosts file, then
  258.   check DNS according to resolv.conf.
  259.  
  260.   /etc/host.conf
  261.  
  262.   It probably contains several lines, one should starting with order and
  263.   it should look like this:
  264.  
  265.   ______________________________________________________________________
  266.   order hosts,bind
  267.   ______________________________________________________________________
  268.  
  269.   If there is no `order' line you should stick one in.  It tells the
  270.   host name resolving routines to first look in /etc/hosts, then ask the
  271.   name server (which you in resolv.conf said is at 127.0.0.1) These two
  272.   latest files are documented in the resolv(8) man page (do `man 8
  273.   resolv') in most Linux distributions.  That man page is IMHO readable,
  274.   and everyone, especially DNS admins, should read it.  Do it now, if
  275.   you say to yourself "I'll do it later" you'll never get around to it.
  276.  
  277.   3.1.  Starting named
  278.  
  279.   After all this it's time to start named.  If you're using a dialup
  280.   connection connect first.  Type `ndc start', and press return, no
  281.   options.  If that back-fires try `/usr/sbin/ndc start' instead.  If
  282.   that back-fires see the ``FAQ'' section.  Now you can test your setup.
  283.   If you view your syslog message file (usually called
  284.   /var/adm/messages, but another directory to look in is /var/log and
  285.   another file to look in is syslog) while starting named (do tail -f
  286.   /var/log/messages) you should see something like:
  287.  
  288.   (the lines ending in  continues on the next line)
  289.  
  290.        Feb 15 01:26:17 roke named[6091]: starting.  named 8.1.1 Sat Feb 14 \
  291.          00:18:20 MET 1998 ^Ijanl@roke.uio.no:/var/tmp/bind-8.1.1/src/bin/named
  292.        Feb 15 01:26:17 roke named[6091]: cache zone "" (IN) loaded (serial 0)
  293.        Feb 15 01:26:17 roke named[6091]: master zone "0.0.127.in-addr.arpa" \
  294.          (IN) loaded (serial 1)
  295.        Feb 15 01:26:17 roke named[6091]: listening [127.0.0.1].53 (lo)
  296.        Feb 15 01:26:17 roke named[6091]: listening [129.240.230.92].53 (ippp0)
  297.        Feb 15 01:26:17 roke named[6091]: Forwarding source address is [0.0.0.0].1040
  298.        Feb 15 01:26:17 roke named[6092]: Ready to answer queries.
  299.  
  300.   If there are any messages about errors then there is a mistake.  Named
  301.   will name the file it is in (one of named.conf and root.hints I hope
  302.   :-) Kill named and go back and check the file.
  303.  
  304.   Now it's time to start nslookup to examine your handy-work.
  305.  
  306.        $ nslookup
  307.        Default Server:  localhost
  308.        Address:  127.0.0.1
  309.  
  310.        >
  311.  
  312.   If that's what you get it's working.  We hope.  Anything else, go back
  313.   and check everything.  Each time you change the named.conf file you
  314.   need to restart named using the ndc restart command.
  315.  
  316.   Now you can enter a query.  Try looking up some machine close to you.
  317.   pat.uio.no is close to me, at the University of Oslo:
  318.  
  319.        > pat.uio.no
  320.        Server:  localhost
  321.        Address:  127.0.0.1
  322.  
  323.        Name:    pat.uio.no
  324.        Address:  129.240.130.16
  325.  
  326.   nslookup now asked your named to look for the machine pat.uio.no.  It
  327.   then contacted one of the name server machines named in your
  328.   root.hints file, and asked its way from there.  It might take tiny
  329.   while before you get the result as it searches all the domains you
  330.   named in /etc/resolv.conf.
  331.  
  332.   If you ask the same again you get this:
  333.  
  334.        > pat.uio.no
  335.        Server:  localhost
  336.        Address:  127.0.0.1
  337.  
  338.        Non-authoritative answer:
  339.        Name:    pat.uio.no
  340.        Address:  129.240.2.50
  341.  
  342.   Note the `Non-authoritative answer:' line we got this time around.
  343.   That means that named did not go out on the network to ask this time,
  344.   it instead looked in it's cache and found it there.  But the cached
  345.   information might be out of date (stale).  So you are informed of this
  346.   (very slight) danger by it saying `Non-authorative answer:'.  When
  347.   nslookup says this the second time you ask for a host it's a sure sign
  348.   that named caches the information and that it's working.  You exit
  349.   nslookup by giving the command `exit'.
  350.  
  351.   Now you know how to set up a caching named.  Take a beer, milk, or
  352.   whatever you prefer to celebrate it.
  353.  
  354.   4.  A simple domain.
  355.  
  356.   How to set up your own domain.
  357.  
  358.   4.1.  But first some dry theory
  359.  
  360.   Before we really start this section I'm going to serve you some theory
  361.   on how DNS works.  And you're going to read it because it's good for
  362.   you.  If you don't `wanna' you should at least skim it very quickly.
  363.   Stop skimming when you get to what should go in your named.conf file.
  364.  
  365.   DNS is a hierarchical system.  The top is written `.' and pronounced
  366.   `root'.  Under . there are a number of Top Level Domains (TLDs), the
  367.   best known ones are ORG, COM, EDU and NET, but there are many more.
  368.  
  369.   When looking for a machine the query proceeds recursively into the
  370.   hierarchy starting at the top.  If you want to find out the address of
  371.   prep.ai.mit.edu your name server has to find a name server that serves
  372.   edu.  It asks a . server (it already knows the .  servers, that's what
  373.   the root.hints file is for), the .  server gives a list of edu
  374.   servers:
  375.  
  376.   $ nslookup
  377.   Default Server:  localhost
  378.   Address:  127.0.0.1
  379.  
  380.   Start asking a root server:
  381.  
  382.        > server c.root-servers.net.
  383.        Default Server:  c.root-servers.net
  384.        Address:  192.33.4.12
  385.  
  386.   Set the Query type to NS (name server records):
  387.  
  388.        > set q=ns
  389.  
  390.   Ask about edu:
  391.  
  392.        > edu.
  393.  
  394.   The trailing . here is significant, it tells the server we're asking
  395.   that edu is right under . (this narrows the search somewhat).
  396.  
  397.        edu     nameserver = A.ROOT-SERVERS.NET
  398.        edu     nameserver = H.ROOT-SERVERS.NET
  399.        edu     nameserver = B.ROOT-SERVERS.NET
  400.        edu     nameserver = C.ROOT-SERVERS.NET
  401.        edu     nameserver = D.ROOT-SERVERS.NET
  402.        edu     nameserver = E.ROOT-SERVERS.NET
  403.        edu     nameserver = I.ROOT-SERVERS.NET
  404.        edu     nameserver = F.ROOT-SERVERS.NET
  405.        edu     nameserver = G.ROOT-SERVERS.NET
  406.        A.ROOT-SERVERS.NET      internet address = 198.41.0.4
  407.        H.ROOT-SERVERS.NET      internet address = 128.63.2.53
  408.        B.ROOT-SERVERS.NET      internet address = 128.9.0.107
  409.        C.ROOT-SERVERS.NET      internet address = 192.33.4.12
  410.        D.ROOT-SERVERS.NET      internet address = 128.8.10.90
  411.        E.ROOT-SERVERS.NET      internet address = 192.203.230.10
  412.        I.ROOT-SERVERS.NET      internet address = 192.36.148.17
  413.        F.ROOT-SERVERS.NET      internet address = 192.5.5.241
  414.        G.ROOT-SERVERS.NET      internet address = 192.112.36.4
  415.  
  416.   This tells us that *.root-servers.net serves edu., so we can go on
  417.   asking c.  Now we want to know who serves the next level of the domain
  418.   name: mit.edu.:
  419.  
  420.        > mit.edu.
  421.        Server:  c.root-servers.net
  422.        Address:  192.33.4.12
  423.  
  424.        Non-authoritative answer:
  425.        mit.edu nameserver = W20NS.mit.edu
  426.        mit.edu nameserver = BITSY.mit.edu
  427.        mit.edu nameserver = STRAWB.mit.edu
  428.  
  429.        Authoritative answers can be found from:
  430.        W20NS.mit.edu   internet address = 18.70.0.160
  431.        BITSY.mit.edu   internet address = 18.72.0.3
  432.        STRAWB.mit.edu  internet address = 18.71.0.151
  433.  
  434.   steawb, w20ns and bitsy serves mit, select one and inquire about
  435.   ai.mit.edu:
  436.  
  437.        > server W20NS.mit.edu.
  438.  
  439.   Host names are not case sensitive, but I use my mouse to cut and paste
  440.   so it gets copied as-is from the screen.
  441.  
  442.   Server:  W20NS.mit.edu
  443.   Address:  18.70.0.160
  444.  
  445.   > ai.mit.edu.
  446.   Server:  W20NS.mit.edu
  447.   Address:  18.70.0.160
  448.  
  449.   Non-authoritative answer:
  450.   ai.mit.edu      nameserver = ALPHA-BITS.AI.MIT.EDU
  451.   ai.mit.edu      nameserver = GRAPE-NUTS.AI.MIT.EDU
  452.   ai.mit.edu      nameserver = TRIX.AI.MIT.EDU
  453.   ai.mit.edu      nameserver = MUESLI.AI.MIT.EDU
  454.   ai.mit.edu      nameserver = LIFE.AI.MIT.EDU
  455.   ai.mit.edu      nameserver = BEET-CHEX.AI.MIT.EDU
  456.   ai.mit.edu      nameserver = MINI-WHEATS.AI.MIT.EDU
  457.   ai.mit.edu      nameserver = COUNT-CHOCULA.AI.MIT.EDU
  458.   ai.mit.edu      nameserver = MINTAKA.LCS.MIT.EDU
  459.  
  460.   Authoritative answers can be found from:
  461.   AI.MIT.EDU      nameserver = ALPHA-BITS.AI.MIT.EDU
  462.   AI.MIT.EDU      nameserver = GRAPE-NUTS.AI.MIT.EDU
  463.   AI.MIT.EDU      nameserver = TRIX.AI.MIT.EDU
  464.   AI.MIT.EDU      nameserver = MUESLI.AI.MIT.EDU
  465.   AI.MIT.EDU      nameserver = LIFE.AI.MIT.EDU
  466.   AI.MIT.EDU      nameserver = BEET-CHEX.AI.MIT.EDU
  467.   AI.MIT.EDU      nameserver = MINI-WHEATS.AI.MIT.EDU
  468.   AI.MIT.EDU      nameserver = COUNT-CHOCULA.AI.MIT.EDU
  469.   AI.MIT.EDU      nameserver = MINTAKA.LCS.MIT.EDU
  470.   ALPHA-BITS.AI.MIT.EDU   internet address = 128.52.32.5
  471.   GRAPE-NUTS.AI.MIT.EDU   internet address = 128.52.36.4
  472.   TRIX.AI.MIT.EDU internet address = 128.52.37.6
  473.   MUESLI.AI.MIT.EDU       internet address = 128.52.39.7
  474.   LIFE.AI.MIT.EDU internet address = 128.52.32.80
  475.   BEET-CHEX.AI.MIT.EDU    internet address = 128.52.32.22
  476.   MINI-WHEATS.AI.MIT.EDU  internet address = 128.52.54.11
  477.   COUNT-CHOCULA.AI.MIT.EDU        internet address = 128.52.38.22
  478.   MINTAKA.LCS.MIT.EDU     internet address = 18.26.0.36
  479.  
  480.   So museli.ai.mit.edu is a nameserver for ai.mit.edu:
  481.  
  482.        > server MUESLI.AI.MIT.EDU
  483.        Default Server:  MUESLI.AI.MIT.EDU
  484.        Address:  128.52.39.7
  485.  
  486.   Now I change query type, we've found the name server so now we're
  487.   going to ask about everything wheaties knows about prep.ai.mit.edu.
  488.  
  489.   > set q=any
  490.   > prep.ai.mit.edu.
  491.   Server:  MUESLI.AI.MIT.EDU
  492.   Address:  128.52.39.7
  493.  
  494.   prep.ai.mit.edu CPU = dec/decstation-5000.25    OS = unix
  495.   prep.ai.mit.edu
  496.           inet address = 18.159.0.42, protocol = tcp
  497.             ftp  telnet  smtp  finger
  498.   prep.ai.mit.edu preference = 1, mail exchanger = gnu-life.ai.mit.edu
  499.   prep.ai.mit.edu internet address = 18.159.0.42
  500.   ai.mit.edu      nameserver = beet-chex.ai.mit.edu
  501.   ai.mit.edu      nameserver = alpha-bits.ai.mit.edu
  502.   ai.mit.edu      nameserver = mini-wheats.ai.mit.edu
  503.   ai.mit.edu      nameserver = trix.ai.mit.edu
  504.   ai.mit.edu      nameserver = muesli.ai.mit.edu
  505.   ai.mit.edu      nameserver = count-chocula.ai.mit.edu
  506.   ai.mit.edu      nameserver = mintaka.lcs.mit.edu
  507.   ai.mit.edu      nameserver = life.ai.mit.edu
  508.   gnu-life.ai.mit.edu     internet address = 128.52.32.60
  509.   beet-chex.ai.mit.edu    internet address = 128.52.32.22
  510.   alpha-bits.ai.mit.edu   internet address = 128.52.32.5
  511.   mini-wheats.ai.mit.edu  internet address = 128.52.54.11
  512.   trix.ai.mit.edu internet address = 128.52.37.6
  513.   muesli.ai.mit.edu       internet address = 128.52.39.7
  514.   count-chocula.ai.mit.edu        internet address = 128.52.38.22
  515.   mintaka.lcs.mit.edu     internet address = 18.26.0.36
  516.   life.ai.mit.edu internet address = 128.52.32.80
  517.  
  518.   So starting at . we found the successive name servers for the next
  519.   level in the domain name.  If you had used your own DNS server instead
  520.   of using all those other servers, your named would of-course cache all
  521.   the information it found while digging this out for you, and it would
  522.   not have to ask again for a while.
  523.  
  524.   A much less talked about, but just as important domain is in-
  525.   addr.arpa.  It too is nested like the `normal' domains.  in-addr.arpa
  526.   allows us to get the hosts name when we have it's address.  A
  527.   important thing here is to note that ip#s are written in reverse order
  528.   in the in-addr.arpa domain.  If you have the address of a machine:
  529.   192.128.52.43 named proceeds just like for the prep.ai.mit.edu
  530.   example: find arpa. servers.  Find in-addr.arpa. servers, find 192.in-
  531.   addr.arpa. servers, find 128.192.in-addr.arpa. servers, find
  532.   52.128.192.in-addr.arpa.  servers.  Find needed records for
  533.   43.52.128.192.in-addr.arpa.  Clever huh? (Say `yes'.)  The reversion
  534.   of the numbers can be confusing the first 2 years though.
  535.  
  536.   I have just told a lie.  DNS does not work literally the way I just
  537.   told you.  But it's close enough.
  538.  
  539.   4.2.  Our own domain
  540.  
  541.   Now to define our own domain.  We're going to make the domain
  542.   linux.bogus and define machines in it.  I use a totally bogus domain
  543.   name to make sure we disturb no-one Out There.
  544.  
  545.   One more thing before we start: Not all characters are allowed in
  546.   host-names.  We're restricted to the characters of the English
  547.   alphabet: a-z, and numbers: 0-9 and the character '-' (dash).  Keep to
  548.   those characters.  Upper and lower-case characters are the same for
  549.   DNS, so pat.uio.no is identical to Pat.UiO.No.
  550.  
  551.   We've already started this part with this line in named.conf:
  552.  
  553.   ______________________________________________________________________
  554.   zone "0.0.127.in-addr.arpa" {
  555.           type master;
  556.           file "pz/127.0.0";
  557.   };
  558.   ______________________________________________________________________
  559.  
  560.   Please note the lack of `.' at the end of the domain names in this
  561.   file.  This says that now we will define the zone 0.0.127.in-
  562.   addr.arpa, that we're the master server for it and that it is stored
  563.   in a file called pz/127.0.0.  We've already set up this file, it
  564.   reads:
  565.  
  566.   ______________________________________________________________________
  567.   @               IN      SOA     ns.linux.bogus. hostmaster.linux.bogus. (
  568.                                   1       ; Serial
  569.                                   8H      ; Refresh
  570.                                   2H      ; Retry
  571.                                   1W      ; Expire
  572.                                   1D)     ; Minimum TTL
  573.                           NS      ns.linux.bogus.
  574.   1                       PTR     localhost.
  575.   ______________________________________________________________________
  576.  
  577.   Please note the `.' at the end of all the full domain names in this
  578.   file, in contrast to the named.conf file above.  Some people like to
  579.   start each zone file with a $ORIGIN directive, but this is
  580.   superfluous.  The origin (where in the DNS hierarchy it belongs) of a
  581.   zone file is specified on the zone line in the named.conf file, in
  582.   this case it's 0.0.127.in-addr.arpa.
  583.  
  584.   This `zone file' contains 3 `resource records' (RRs): A SOA RR.  A NS
  585.   RR and a PTR RR.  SOA is short for Start Of Authority.  The `@' is a
  586.   special notation meaning the origin, and since the `domain' column for
  587.   this file says 0.0.127.in-addr.arpa the first line really means
  588.  
  589.        0.0.127.in-addr.arpa.   IN      SOA ...
  590.  
  591.   NS is the Name Server RR.  There is no '@' at the start of this line,
  592.   it is implicit since the last line started with a '@'.  Saves some
  593.   typing that.  So the NS line really reads
  594.  
  595.   0.0.127.in-addr.arpa.   IN      NS      ns.linux.bogus
  596.  
  597.   It tells DNS what machine is the name server of the domain 0.0.127.in-
  598.   addr.arpa, it is ns.linux.bogus.  'ns' is a customary name for name-
  599.   servers, but as with web servers who are customarily named
  600.   www.something the name may be anything.
  601.  
  602.   And finally the PTR record says that the host at address 1 in the
  603.   subnet 0.0.127.in-addr.arpa, i.e., 127.0.0,1 is named localhost.
  604.  
  605.   The SOA record is the preamble to all zone files, and there should be
  606.   exactly one in each zone file, the very first record.  It describes
  607.   the zone, where it comes from (a machine called ns.linux.bogus), who
  608.   is responsible for its contents (hostmaster@linux.bogus), what version
  609.   of the zone file this is (serial: 1), and other things having to do
  610.   with caching and secondary DNS servers.  For the rest of the fields,
  611.   refresh, retry, expire and minimum use the numbers used in this HOWTO
  612.   and you should be safe.
  613.  
  614.   Now restart your named (the command is ndc restart) and use nslookup
  615.   to examine what you've done:
  616.  
  617.        $ nslookup
  618.  
  619.        Default Server:  localhost
  620.        Address:  127.0.0.1
  621.  
  622.        > 127.0.0.1
  623.        Server:  localhost
  624.        Address:  127.0.0.1
  625.  
  626.        Name:    localhost
  627.        Address:  127.0.0.1
  628.  
  629.   so it manages to get localhost from 127.0.0.1, good.  Now for our main
  630.   task, the linux.bogus domain, insert a new 'zone' section in
  631.   named.conf:
  632.  
  633.   ______________________________________________________________________
  634.   zone "linux.bogus" {
  635.           notify no;
  636.           type master;
  637.           file "pz/linux.bogus";
  638.   };
  639.   ______________________________________________________________________
  640.  
  641.   Note the continued lack of ending `.' on the domain name in the
  642.   named.conf file.
  643.  
  644.   In the linux.bogus zone file we'll put some totally bogus data:
  645.  
  646.   ______________________________________________________________________
  647.   ;
  648.   ; Zone file for linux.bogus
  649.   ;
  650.   ; The full zone file
  651.   ;
  652.   @       IN      SOA     ns.linux.bogus. hostmaster.linux.bogus. (
  653.                           199802151       ; serial, todays date + todays serial #
  654.                           8H              ; refresh, seconds
  655.                           2H              ; retry, seconds
  656.                           1W              ; expire, seconds
  657.                           1D )            ; minimum, seconds
  658.   ;
  659.                   NS      ns              ; Inet Address of name server
  660.                   MX      10 mail.linux.bogus     ; Primary Mail Exchanger
  661.                   MX      20 mail.friend.bogus.   ; Secondary Mail Exchanger
  662.   ;
  663.   localhost       A       127.0.0.1
  664.   ns              A       192.168.196.2
  665.   mail            A       192.168.196.4
  666.   ______________________________________________________________________
  667.  
  668.   Two things must be noted about the SOA record.  ns.linux.bogus must be
  669.   a actual machine with a A record.  It is not legal to have a CNAME
  670.   record for he machine mentioned in the SOA record.  It's name need not
  671.   be `ns', it could be any legal host name.  Next,
  672.   hostmaster.linux.bogus should be read as hostmaster@linux.bogus, this
  673.   should be a mail alias, or a mailbox, where the person(s) maintaining
  674.   DNS should read mail frequently.  Any mail regarding the domain will
  675.   be sent to the address listed here.  The name need not be
  676.   `hostmaster', it can be any legal e-mail address, but the e-mail
  677.   address `hostmaster' is expected to work as well.
  678.  
  679.   There is one new RR type in this file, the MX, or Mail eXchanger RR.
  680.   It tells mail systems where to send mail that is addressed to
  681.   someone@linux.bogus, namely too mail.linux.bogus or mail.friend.bogus.
  682.   The number before each machine name is that MX RRs priority.  The RR
  683.   with the lowest number (10) is the one mail should be sent to
  684.   primarily.  If that fails it can be sent to one with a higher number,
  685.   a secondary mail handler, i.e., mail.friend.bogus which has priority
  686.   20 here.
  687.  
  688.   Restart named by running ndc restart.  Examine the results with
  689.   nslookup:
  690.  
  691.   $ nslookup
  692.   > set q=any
  693.   > linux.bogus
  694.   Server:  localhost
  695.   Address:  127.0.0.1
  696.  
  697.   linux.bogus
  698.           origin = ns.linux.bogus
  699.           mail addr = hostmaster.linux.bogus
  700.           serial = 199802151
  701.           refresh = 28800 (8 hours)
  702.           retry   = 7200 (2 hours)
  703.           expire  = 604800 (7 days)
  704.           minimum ttl = 86400 (1 day)
  705.   linux.bogus     nameserver = ns.linux.bogus
  706.   linux.bogus     preference = 10, mail exchanger = mail.linux.bogus.linux.bogus
  707.   linux.bogus     preference = 20, mail exchanger = mail.friend.bogus
  708.   linux.bogus     nameserver = ns.linux.bogus
  709.   ns.linux.bogus  internet address = 192.168.196.2
  710.   mail.linux.bogus        internet address = 192.168.196.4
  711.  
  712.   Upon careful examination you will discover a bug.  The line
  713.  
  714.        linux.bogus     preference = 10, mail exchanger = mail.linux.bogus.linux.bogus
  715.  
  716.   is all wrong.  It should be
  717.  
  718.        linux.bogus     preference = 10, mail exchanger = mail.linux.bogus
  719.  
  720.   I deliberately made a mistake so you could learn from it :-) Looking
  721.   in the zone file we find that the line
  722.  
  723.                        MX      10 mail.linux.bogus     ; Primary Mail Exchanger
  724.  
  725.   is missing a period.  Or has a 'linux.bogus' too many.  If a machine
  726.   name does not end in a period in a zone file the origin is added to
  727.   its end causing the double linux.bogus.linux.bogus.  So either
  728.  
  729.   ______________________________________________________________________
  730.                   MX      10 mail.linux.bogus.    ; Primary Mail Exchanger
  731.   ______________________________________________________________________
  732.  
  733.   or
  734.  
  735.   ______________________________________________________________________
  736.                   MX      10 mail                 ; Primary Mail Exchanger
  737.   ______________________________________________________________________
  738.  
  739.   is correct.  I prefer the latter form, it's less to type.  There are
  740.   some, knowledgable, bind users that disagree, and some that agree with
  741.   this.  In a zone file the domain should either be written out and
  742.   ended with a `.' or it should not be included at all, in which case it
  743.   defaults to the origin.
  744.  
  745.   I must stress that in the named.conf file there should not be `.'s
  746.   after the domain names.  You have no idea how many times a `.' too
  747.   many or few have fouled up things and confused the h*ll out of people.
  748.  
  749.   So having made my point here is the new zone file, with some extra
  750.   information in it as well:
  751.  
  752.   ______________________________________________________________________
  753.   ;
  754.   ; Zone file for linux.bogus
  755.   ;
  756.   ; The full zone file
  757.   ;
  758.   @       IN      SOA     ns.linux.bogus. hostmaster.linux.bogus. (
  759.                           199802151       ; serial, todays date + todays serial #
  760.                           8H              ; refresh, seconds
  761.                           2H              ; retry, seconds
  762.                           1W              ; expire, seconds
  763.                           1D )            ; minimum, seconds
  764.   ;
  765.                   TXT     "Linux.Bogus, your DNS consultants"
  766.                   NS      ns              ; Inet Address of name server
  767.                   NS      ns.friend.bogus.
  768.                   MX      10 mail         ; Primary Mail Exchanger
  769.                   MX      20 mail.friend.bogus. ; Secondary Mail Exchanger
  770.  
  771.   localhost       A       127.0.0.1
  772.  
  773.   gw              A       192.168.196.1
  774.                   HINFO   "Cisco" "IOS"
  775.                   TXT     "The router"
  776.  
  777.   ns              A       192.168.196.2
  778.                   MX      10 mail
  779.                   MX      20 mail.friend.bogus.
  780.                   HINFO   "Pentium" "Linux 2.0"
  781.   www             CNAME   ns
  782.  
  783.   donald          A       192.168.196.3
  784.                   MX      10 mail
  785.                   MX      20 mail.friend.bogus.
  786.                   HINFO   "i486"  "Linux 2.0"
  787.                   TXT     "DEK"
  788.  
  789.   mail            A       192.168.196.4
  790.                   MX      10 mail
  791.                   MX      20 mail.friend.bogus.
  792.                   HINFO   "386sx" "Linux 1.2"
  793.  
  794.   ftp             A       192.168.196.5
  795.                   MX      10 mail
  796.                   MX      20 mail.friend.bogus.
  797.                   HINFO   "P6" "Linux 2.1.86"
  798.   ______________________________________________________________________
  799.  
  800.   There are a number of new RRs here: HINFO (Host INFOrmation) has two
  801.   parts, it's a good habit to quote each.  The first part is the
  802.   hardware or CPU on the machine, and the second part the software or OS
  803.   on the machine.  The machine called 'ns' has a Pentium CPU and runs
  804.   Linux 2.0.  CNAME (Canonical NAME) is a way to give each machine
  805.   several names.  So www is an alias for ns.
  806.  
  807.   CNAME record usage is a bit controversial.  But it's safe to follow
  808.   the rule that a MX, CNAME or SOA record should never refer to a CNAME
  809.   record, they should only refer to something with a A record, so it
  810.   would wrong to have
  811.  
  812.   ______________________________________________________________________
  813.   foobar          CNAME   www                     ; NO!
  814.   ______________________________________________________________________
  815.  
  816.   but correct to have
  817.  
  818.   ______________________________________________________________________
  819.   foobar          CNAME   ns                      ; Yes!
  820.   ______________________________________________________________________
  821.  
  822.   It's also safe to assume that a CNAME is not a legal host name for a
  823.   e-mail address: webmaster@www.linux.bogus is an ilegal e-mail address
  824.   given the setup above.  You can expect quite a few mail admins Out
  825.   There to enforce this rule even if it works for you.  The way to avoid
  826.   this is to use A records (and perhaps some others too, like a MX
  827.   record) instead:
  828.  
  829.   ______________________________________________________________________
  830.   www             A       192.168.196.2
  831.   ______________________________________________________________________
  832.  
  833.   A number of the arch-bind-wizards, recommends not using CNAME.  So
  834.   consider not using it very seriously.
  835.  
  836.   But as you see, this HOWTO and many sites does not follow this rule.
  837.  
  838.   Load the new database by running ndc reload, this causes named to read
  839.   its files again.
  840.  
  841.        $ nslookup
  842.        Default Server:  localhost
  843.        Address:  127.0.0.1
  844.  
  845.        > ls -d linux.bogus
  846.  
  847.   This means that all records should be listed.  It results in this:
  848.  
  849.   [localhost]
  850.   $ORIGIN linux.bogus.
  851.   @                       1D IN SOA       ns hostmaster (
  852.                                           199802151       ; serial
  853.                                           8H              ; refresh
  854.                                           2H              ; retry
  855.                                           1W              ; expiry
  856.                                           1D )            ; minimum
  857.  
  858.                           1D IN NS        ns
  859.                           1D IN NS        ns.friend.bogus.
  860.                           1D IN TXT       "Linux.Bogus, your DNS consultants"
  861.                           1D IN MX        10 mail
  862.                           1D IN MX        20 mail.friend.bogus.
  863.   gw                      1D IN A         192.168.196.1
  864.                           1D IN HINFO     "Cisco" "IOS"
  865.                           1D IN TXT       "The router"
  866.   mail                    1D IN A         192.168.196.4
  867.                           1D IN MX        10 mail
  868.                           1D IN MX        20 mail.friend.bogus.
  869.                           1D IN HINFO     "386sx" "Linux 1.0.9"
  870.   localhost               1D IN A         127.0.0.1
  871.   www                     1D IN CNAME     ns
  872.   donald                  1D IN A         192.168.196.3
  873.                           1D IN MX        10 mail
  874.                           1D IN MX        20 mail.friend.bogus.
  875.                           1D IN HINFO     "i486" "Linux 1.2"
  876.                           1D IN TXT       "DEK"
  877.   ftp                     1D IN A         192.168.196.5
  878.                           1D IN MX        10 mail
  879.                           1D IN MX        20 mail.friend.bogus.
  880.                           1D IN HINFO     "P6" "Linux 1.3.59"
  881.   ns                      1D IN A         192.168.196.2
  882.                           1D IN MX        10 mail
  883.                           1D IN MX        20 mail.friend.bogus.
  884.                           1D IN HINFO     "Pentium" "Linux 1.2"
  885.   @                       1D IN SOA       ns hostmaster (
  886.                                           199802151       ; serial
  887.                                           8H              ; refresh
  888.                                           2H              ; retry
  889.                                           1W              ; expiry
  890.                                           1D )            ; minimum
  891.  
  892.   That's good.  As you see it looks a lot like the zone file itself.
  893.   Let's check what it says for www alone:
  894.  
  895.        > set q=any
  896.        > www.linux.bogus.
  897.        Server:  localhost
  898.        Address:  127.0.0.1
  899.  
  900.        www.linux.bogus canonical name = ns.linux.bogus
  901.        linux.bogus     nameserver = ns.linux.bogus
  902.        linux.bogus     nameserver = ns.friend.bogus
  903.        ns.linux.bogus  internet address = 192.168.196.2
  904.  
  905.   In other words, the real name of www.linux.bogus is ns.linux.bogus,
  906.   and it gives you some of the information it has about ns as well,
  907.   enough to connect to it if you were a program.
  908.  
  909.   Now we're halfway.
  910.  
  911.   4.3.  The reverse zone
  912.  
  913.   Now programs can convert the names in linux.bogus to addresses which
  914.   they can connect to.  But also required is a reverse zone, one making
  915.   DNS able to convert from an address to a name.  This name is used buy
  916.   a lot of servers of different kinds (FTP, IRC, WWW and others) to
  917.   decide if they want to talk to you or not, and if so, maybe even how
  918.   much priority you should be given.  For full access to all services on
  919.   the Internet a reverse zone is required.
  920.  
  921.   Put this in named.conf:
  922.  
  923.   ______________________________________________________________________
  924.   zone "196.168.192.in-addr.arpa" {
  925.           notify no;
  926.           type master;
  927.           file "pz/192.168.196";
  928.   };
  929.   ______________________________________________________________________
  930.  
  931.   This is exactly as with the 0.0.127.in-addr.arpa, and the contents are
  932.   similar:
  933.  
  934.   ______________________________________________________________________
  935.   @       IN      SOA     ns.linux.bogus. hostmaster.linux.bogus. (
  936.                           199802151 ; Serial, todays date + todays serial
  937.                           8H      ; Refresh
  938.                           2H      ; Retry
  939.                           1W      ; Expire
  940.                           1D)     ; Minimum TTL
  941.                   NS      ns.linux.bogus.
  942.  
  943.   1               PTR     gw.linux.bogus.
  944.   2               PTR     ns.linux.bogus.
  945.   3               PTR     donald.linux.bogus.
  946.   4               PTR     mail.linux.bogus.
  947.   5               PTR     donald.linux.bogus.
  948.   ______________________________________________________________________
  949.  
  950.   Now you restart your named (ndc restart) and examine your work with
  951.   nslookup again:
  952.  
  953.   ______________________________________________________________________
  954.   > 192.168.196.4
  955.   Server:  localhost
  956.   Address:  127.0.0.1
  957.  
  958.   Name:    mail.linux.bogus
  959.   Address:  192.168.196.4
  960.   ______________________________________________________________________
  961.  
  962.   so, it looks OK, dump the whole thing to examine that too:
  963.  
  964.   ______________________________________________________________________
  965.   > ls -d 196.168.192.in-addr.arpa
  966.   [localhost]
  967.   $ORIGIN 196.168.192.in-addr.arpa.
  968.   @                       1D IN SOA       ns.linux.bogus. hostmaster.linux.bogus. (
  969.                                           199802151       ; serial
  970.                                           8H              ; refresh
  971.                                           2H              ; retry
  972.                                           1W              ; expiry
  973.                                           1D )            ; minimum
  974.  
  975.                           1D IN NS        ns.linux.bogus.
  976.   1                       1D IN PTR       gw.linux.bogus.
  977.   2                       1D IN PTR       ns.linux.bogus.
  978.   3                       1D IN PTR       donald.linux.bogus.
  979.   4                       1D IN PTR       mail.linux.bogus.
  980.   5                       1D IN PTR       donald.linux.bogus.
  981.   @                       1D IN SOA       ns.linux.bogus. hostmaster.linux.bogus. (
  982.                                           199802151       ; serial
  983.                                           8H              ; refresh
  984.                                           2H              ; retry
  985.                                           1W              ; expiry
  986.                                           1D )            ; minimum
  987.   ______________________________________________________________________
  988.  
  989.   Looks good!
  990.  
  991.   There are some things I should add here.  The IP numbers used in the
  992.   examples above are taken from one of the blocks of 'private nets',
  993.   i.e., they are not allowed to be used publicly on the internet.  So
  994.   they are safe to use in an example in a HOWTO.  The second thing is
  995.   the notify no; line.  It tells named not to notify its secondary
  996.   (slave) servers when it has gotten a update to one of its zone files.
  997.   In bind-8 the named can notify the other servers listed in NS records
  998.   in the zone file when a zone is updated.  This is handy for ordinary
  999.   use, but for private experiments with zones this feature should be
  1000.   off, we don't want the experiment to pollute the internet do we?
  1001.  
  1002.   And, of course, this domain is highly bogus, and so are all the
  1003.   addresses in it.  For a real example of a real-life domain see the
  1004.   next section.
  1005.  
  1006.   5.  A real domain example
  1007.  
  1008.   Where we list some real zone files
  1009.  
  1010.   Users have suggested that I include a real example of a working domain
  1011.   as well as the tutorial example.
  1012.  
  1013.   I use this example with permission from David Bullock of LAND-5.
  1014.   These files were current 24th of September 1996, and were then edited
  1015.   to fit bind-8 restrictions and use extensions by me.  So, what you see
  1016.   here differs a bit from what you find if you query LAND-5's name
  1017.   servers now.
  1018.  
  1019.   5.1.  /etc/named.conf (or /var/named/named.conf)
  1020.  
  1021.   Here we find primary lines for the two reverse zones needed: the
  1022.   127.0.0 net, as well as LAND-5's 206.6.177 subnet.  And a primary line
  1023.   for land-5's forward zone land-5.com.  Also note that instead of
  1024.   stuffing the files in a directory called pz, as I do in this HOWTO, he
  1025.   puts them in a directory called zone.
  1026.  
  1027.   ______________________________________________________________________
  1028.   // Boot file for LAND-5 name server
  1029.  
  1030.   options {
  1031.           directory "/var/named";
  1032.   };
  1033.  
  1034.   zone "." {
  1035.           type hint;
  1036.           file "root.hints";
  1037.   };
  1038.  
  1039.   zone "0.0.127.in-addr.arpa" {
  1040.           type master;
  1041.           file "zone/127.0.0";
  1042.   };
  1043.  
  1044.   zone "land-5.com" {
  1045.           type master;
  1046.           file "zone/land-5.com";
  1047.   };
  1048.  
  1049.   zone "177.6.206.in-addr.arpa" {
  1050.           type master;
  1051.           file "zone/206.6.177";
  1052.   };
  1053.   ______________________________________________________________________
  1054.  
  1055.   If you put this in your named.conf file to play with PLEASE put notify
  1056.   no; in the zone sections for the two land-5 zones so as to avoid
  1057.   accidents.
  1058.  
  1059.   5.2.  /var/named/root.hints
  1060.  
  1061.   Keep in mind that this file is dynamic, and the one listed here is
  1062.   old.  You're better off using one produced now, with dig , as
  1063.   explained earlier.
  1064.   ______________________________________________________________________
  1065.   ; <<>> DiG 8.1 <<>> @A.ROOT-SERVERS.NET.
  1066.   ; (1 server found)
  1067.   ;; res options: init recurs defnam dnsrch
  1068.   ;; got answer:
  1069.   ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 10
  1070.   ;; flags: qr aa rd; QUERY: 1, ANSWER: 13, AUTHORITY: 0, ADDITIONAL: 13
  1071.   ;; QUERY SECTION:
  1072.   ;;      ., type = NS, class = IN
  1073.  
  1074.   ;; ANSWER SECTION:
  1075.   \&.                       6D IN NS        G.ROOT-SERVERS.NET.
  1076.   \&.                       6D IN NS        J.ROOT-SERVERS.NET.
  1077.   \&.                       6D IN NS        K.ROOT-SERVERS.NET.
  1078.   \&.                       6D IN NS        L.ROOT-SERVERS.NET.
  1079.   \&.                       6D IN NS        M.ROOT-SERVERS.NET.
  1080.   \&.                       6D IN NS        A.ROOT-SERVERS.NET.
  1081.   \&.                       6D IN NS        H.ROOT-SERVERS.NET.
  1082.   \&.                       6D IN NS        B.ROOT-SERVERS.NET.
  1083.   \&.                       6D IN NS        C.ROOT-SERVERS.NET.
  1084.   \&.                       6D IN NS        D.ROOT-SERVERS.NET.
  1085.   \&.                       6D IN NS        E.ROOT-SERVERS.NET.
  1086.   \&.                       6D IN NS        I.ROOT-SERVERS.NET.
  1087.   \&.                       6D IN NS        F.ROOT-SERVERS.NET.
  1088.  
  1089.   ;; ADDITIONAL SECTION:
  1090.   G.ROOT-SERVERS.NET.     5w6d16h IN A    192.112.36.4
  1091.   J.ROOT-SERVERS.NET.     5w6d16h IN A    198.41.0.10
  1092.   K.ROOT-SERVERS.NET.     5w6d16h IN A    193.0.14.129
  1093.   L.ROOT-SERVERS.NET.     5w6d16h IN A    198.32.64.12
  1094.   M.ROOT-SERVERS.NET.     5w6d16h IN A    202.12.27.33
  1095.   A.ROOT-SERVERS.NET.     5w6d16h IN A    198.41.0.4
  1096.   H.ROOT-SERVERS.NET.     5w6d16h IN A    128.63.2.53
  1097.   B.ROOT-SERVERS.NET.     5w6d16h IN A    128.9.0.107
  1098.   C.ROOT-SERVERS.NET.     5w6d16h IN A    192.33.4.12
  1099.   D.ROOT-SERVERS.NET.     5w6d16h IN A    128.8.10.90
  1100.   E.ROOT-SERVERS.NET.     5w6d16h IN A    192.203.230.10
  1101.   I.ROOT-SERVERS.NET.     5w6d16h IN A    192.36.148.17
  1102.   F.ROOT-SERVERS.NET.     5w6d16h IN A    192.5.5.241
  1103.  
  1104.   ;; Total query time: 215 msec
  1105.   ;; FROM: roke.uio.no to SERVER: A.ROOT-SERVERS.NET.  198.41.0.4
  1106.   ;; WHEN: Sun Feb 15 01:22:51 1998
  1107.   ;; MSG SIZE  sent: 17  rcvd: 436
  1108.   ______________________________________________________________________
  1109.  
  1110.   5.3.  /var/named/zone/127.0.0
  1111.  
  1112.   Just the basics, the obligatory SOA record, and a record that maps
  1113.   127.0.0.1 to localhost.  Both are required.  No more should be in this
  1114.   file.  It will probably never need to be updated, unless your
  1115.   nameserver or hostmaster address changes.
  1116.  
  1117.   ______________________________________________________________________
  1118.   @               IN      SOA     land-5.com. root.land-5.com. (
  1119.                                   199609203       ; Serial
  1120.                                   28800   ; Refresh
  1121.                                   7200    ; Retry
  1122.                                   604800  ; Expire
  1123.                                   86400)  ; Minimum TTL
  1124.                           NS      land-5.com.
  1125.  
  1126.   1                       PTR     localhost.
  1127.   ______________________________________________________________________
  1128.  
  1129.   5.4.  /var/named/zone/land-5.com
  1130.  
  1131.   Here we see the mandatory SOA record, the needed NS records.  We can
  1132.   see that he has a secondary name server at ns2.psi.net.  This is as it
  1133.   should be, always have a off site secondary server as backup.  We can
  1134.   also see that he has a master host called land-5 which takes care of
  1135.   many of the different Internet services, and that he's done it with
  1136.   CNAMEs (a alternative is using A records).
  1137.  
  1138.   As you see from the SOA record, the zone file originates at
  1139.   land-5.com, the contact person is root@land-5.com. hostmaster is
  1140.   another oft used address for the contact person.  The serial number is
  1141.   in the customary yyyymmdd format with todays serial number appended;
  1142.   this is probably the sixth version of zone file on the 20th of
  1143.   September 1996.  Remember that the serial number must increase
  1144.   monotonically, here there is only one digit for todays serial#, so
  1145.   after 9 edits he has to wait until tomorrow before he can edit the
  1146.   file again.  Consider using two digits.
  1147.  
  1148.   ______________________________________________________________________
  1149.   @       IN      SOA     land-5.com. root.land-5.com. (
  1150.                           199609206       ; serial, todays date + todays serial #
  1151.                           8H              ; refresh, seconds
  1152.                           2H              ; retry, seconds
  1153.                           1W              ; expire, seconds
  1154.                           1D )            ; minimum, seconds
  1155.                   NS      land-5.com.
  1156.                   NS      ns2.psi.net.
  1157.                   MX      10 land-5.com.  ; Primary Mail Exchanger
  1158.  
  1159.   localhost       A       127.0.0.1
  1160.  
  1161.   router          A       206.6.177.1
  1162.  
  1163.   land-5.com.     A       206.6.177.2
  1164.   ns              A       206.6.177.3
  1165.   www             A       207.159.141.192
  1166.  
  1167.   ftp             CNAME   land-5.com.
  1168.   mail            CNAME   land-5.com.
  1169.   news            CNAME   land-5.com.
  1170.  
  1171.   funn            A       206.6.177.2
  1172.   @               TXT     "LAND-5 Corporation"
  1173.  
  1174.   ;
  1175.   ;       Workstations
  1176.   ;
  1177.   ws-177200       A       206.6.177.200
  1178.                   MX      10 land-5.com.   ; Primary Mail Host
  1179.   ws-177201       A       206.6.177.201
  1180.                   MX      10 land-5.com.   ; Primary Mail Host
  1181.   ws-177202       A       206.6.177.202
  1182.                   MX      10 land-5.com.   ; Primary Mail Host
  1183.   ws-177203       A       206.6.177.203
  1184.                   MX      10 land-5.com.   ; Primary Mail Host
  1185.   ws-177204       A       206.6.177.204
  1186.                   MX      10 land-5.com.   ; Primary Mail Host
  1187.   ws-177205       A       206.6.177.205
  1188.                   MX      10 land-5.com.   ; Primary Mail Host
  1189.   ; {Many repetitive definitions deleted - SNIP}
  1190.   ws-177250       A       206.6.177.250
  1191.                   MX      10 land-5.com.   ; Primary Mail Host
  1192.   ws-177251       A       206.6.177.251
  1193.                   MX      10 land-5.com.   ; Primary Mail Host
  1194.   ws-177252       A       206.6.177.252
  1195.                   MX      10 land-5.com.   ; Primary Mail Host
  1196.   ws-177253       A       206.6.177.253
  1197.                   MX      10 land-5.com.   ; Primary Mail Host
  1198.   ws-177254       A       206.6.177.254
  1199.                   MX      10 land-5.com.   ; Primary Mail Host
  1200.   ______________________________________________________________________
  1201.  
  1202.   If you examine land-5s nameserver you will find that the host names
  1203.   are of the form ws_number.  As of late bind 4 versions named started
  1204.   enforcing the restrictions on what characters may be used in host
  1205.   names.  So that does not work with bind-8 at all, and I substituted
  1206.   '-' (dash) for '_' (underline).
  1207.  
  1208.   Another thing to note is that the workstations don't have individual
  1209.   names, but rather a prefix followed by the two last parts of the IP
  1210.   numbers.  Using such a convention can simplify maintenance
  1211.   significantly, but can be a bit impersonal, and, in fact, be a source
  1212.   of disgruntlement among your customers.
  1213.  
  1214.   We also see that funn.land-5.com is an alias for land-5.com, but using
  1215.   an A record, not a CNAME record.
  1216.  
  1217.   5.5.  /var/named/zone/206.6.177
  1218.  
  1219.   I'll comment on this file after it.
  1220.  
  1221.   ______________________________________________________________________
  1222.   @               IN      SOA     land-5.com. root.land-5.com. (
  1223.                                   199609206       ; Serial
  1224.                                   28800   ; Refresh
  1225.                                   7200    ; Retry
  1226.                                   604800  ; Expire
  1227.                                   86400)  ; Minimum TTL
  1228.                           NS      land-5.com.
  1229.                           NS      ns2.psi.net.
  1230.   ;
  1231.   ;       Servers
  1232.   ;
  1233.   1       PTR     router.land-5.com.
  1234.   2       PTR     land-5.com.
  1235.   2       PTR     funn.land-5.com.
  1236.   ;
  1237.   ;       Workstations
  1238.   ;
  1239.   200     PTR     ws-177200.land-5.com.
  1240.   201     PTR     ws-177201.land-5.com.
  1241.   202     PTR     ws-177202.land-5.com.
  1242.   203     PTR     ws-177203.land-5.com.
  1243.   204     PTR     ws-177204.land-5.com.
  1244.   205     PTR     ws-177205.land-5.com.
  1245.   ; {Many repetitive definitions deleted - SNIP}
  1246.   250     PTR     ws-177250.land-5.com.
  1247.   251     PTR     ws-177251.land-5.com.
  1248.   252     PTR     ws-177252.land-5.com.
  1249.   253     PTR     ws-177253.land-5.com.
  1250.   254     PTR     ws-177254.land-5.com.
  1251.   ______________________________________________________________________
  1252.  
  1253.   The reverse zone is the bit of the setup that seems to cause the most
  1254.   grief.  It is used to find the host name if you have the IP number of
  1255.   a machine.  Example: you are an IRC server and accept connections from
  1256.   IRC clients.  However you are a Norwegian IRC server and so you only
  1257.   want to accept connections from clients in Norway and other
  1258.   Scandinavian countries.  When you get a connection from a client the C
  1259.   library is able to tell you the IP number of the connecting machine
  1260.   because the IP number of the client is contained in all the packets
  1261.   that are passed over the network.  Now you can call a function called
  1262.   gethostbyaddr that looks up the name of a host given the IP number.
  1263.   Gethostbyaddr will ask a DNS server, which will then traverse the DNS
  1264.   looking for the machine.  Supposing the client connection is from
  1265.   ws-177200.land-5.com.  The IP number the C library provides to the IRC
  1266.   server is 206.6.177.200.  To find out the name of that machine we need
  1267.   to find 200.177.6.206.in-addr.arpa.  The DNS server will first find
  1268.   the arpa. servers, then find in-addr.arpa. servers, following the
  1269.   reverse trail through 206, then 6 and at last finding the server for
  1270.   the 177.6.206.in-addr.arpa zone at land-5.  From which it will finally
  1271.   get the answer that for 200.177.6.206.in-addr.arpa we have a 'PTR
  1272.   ws-177200.land-5.com' record, meaning that the name that goes with
  1273.   206.6.177.200 is ws-177200.land-5.com.  As with the explanation of how
  1274.   prep.ai.mit.edu is looked up, this is slightly fictitious.
  1275.  
  1276.   Getting back to the IRC server example.  The IRC server only accepts
  1277.   connections from the Scandinavian countries, i.e., *.no, *.se, *.dk,
  1278.   the name ws-177200.land-5.com clearly does not match any of those, and
  1279.   the server will deny the connection.  If there was no reverse mapping
  1280.   of 206.2.177.200 through the in-addr.arpa zone the server would have
  1281.   been unable to find the name at all and would have to settle to
  1282.   comparing 206.2.177.200 with *.no, *.se and *.dk, none of which will
  1283.   match.
  1284.  
  1285.   Some people will tell you that reverse lookup mappings are only
  1286.   important for servers, or not important at all.  Not so: Many ftp,
  1287.   news, IRC and even some http (WWW) servers will not accept connections
  1288.   from machines that they are not able to find the name of.  So reverse
  1289.   mappings for machines are in fact mandatory.
  1290.  
  1291.   6.  Maintenance
  1292.  
  1293.   Keeping it working.
  1294.  
  1295.   There is one maintenance task you have to do on nameds, other than
  1296.   keeping them running.  That's keeping the root.hints file updated.
  1297.   The easiest way is using dig, first run dig with no arguments, you
  1298.   will get the root.hints according to your own server.  Then ask one of
  1299.   the listed root servers with dig @rootserver.  You will note that the
  1300.   output looks terribly like a root.hints file.  Save it to a file (dig
  1301.   @e.root-servers.net . ns >root.hints.new) and replace the old
  1302.   root.hints with it.
  1303.  
  1304.   Remember to restart named after replacing the cache file.
  1305.  
  1306.   Al Longyear sent me this script that can be run automatically to
  1307.   update root.hints, install a crontab entry to run it once a month and
  1308.   forget it.  The script assumes you have mail working and that the
  1309.   mail-alias `hostmaster' is defined.  You must hack it to suit your
  1310.   setup.
  1311.  
  1312.   ______________________________________________________________________
  1313.   #!/bin/sh
  1314.   #
  1315.   # Update the nameserver cache information file once per month.
  1316.   # This is run automatically by a cron entry.
  1317.   #
  1318.   (
  1319.    echo "To: hostmaster <hostmaster>"
  1320.    echo "From: system <root>"
  1321.    echo "Subject: Automatic update of the named.conf file"
  1322.    echo
  1323.  
  1324.    export PATH=/sbin:/usr/sbin:/bin:/usr/bin:
  1325.    cd /var/named
  1326.  
  1327.    dig @rs.internic.net . ns >root.hints.new
  1328.  
  1329.    echo "The named.conf file has been updated to contain the following
  1330.   information:"
  1331.    echo
  1332.    cat root.hints.new
  1333.  
  1334.    chown root.root root.hints.new
  1335.    chmod 444 root.hints.new
  1336.    rm -f root.hints.old
  1337.    mv root.hints root.hints.old
  1338.    mv root.hints.new root.hints
  1339.    ndc restart
  1340.    echo
  1341.    echo "The nameserver has been restarted to ensure that the update is complete."
  1342.    echo "The previous root.hints file is now called
  1343.   /var/named/root.hints.old."
  1344.   ) 2>&1 | /usr/lib/sendmail -t
  1345.   exit 0
  1346.   ______________________________________________________________________
  1347.  
  1348.   Some of you might have picked up that the root.hints file is also
  1349.   available by ftp from Internic.  Please don't use ftp to update
  1350.   root.hints, the above method is much more friendly to the net.
  1351.  
  1352.   7.  Converting from version 4 to version 8
  1353.  
  1354.   This was originally a section on using bind 8 written by David E.
  1355.   Smith (dave@bureau42.ml.org).  I have edited it some to fit the new
  1356.   section name.
  1357.  
  1358.   There's not much to it.  Except for using named.conf instead of
  1359.   named.conf, everything is identical.  And bind8 comes with a perl
  1360.   script that converts old-style files to new.  Example named.conf (old
  1361.   style) for a cache-only name server:
  1362.  
  1363.   ______________________________________________________________________
  1364.   directory /var/named
  1365.   cache   .                                       root.hints
  1366.   primary 0.0.127.IN-ADDR.ARPA                    127.0.0.zone
  1367.   primary localhost                               localhost.zone
  1368.   ______________________________________________________________________
  1369.  
  1370.   On the command line, in the bind8/src/bin/named directory (this
  1371.   assumes you got a source distribution. If you got a binary package the
  1372.   script is probably around, I'm not sure where it would be though.
  1373.   -ed.), type:
  1374.  
  1375.   ______________________________________________________________________
  1376.   ______________________________________________________________________
  1377.  
  1378.   Which creates named.conf:
  1379.  
  1380.   ______________________________________________________________________
  1381.   // generated by named-bootconf.pl
  1382.  
  1383.   options {
  1384.           directory "/var/named";
  1385.   };
  1386.  
  1387.   zone "." {
  1388.           type hint;
  1389.           file "root.hints";
  1390.   };
  1391.  
  1392.   zone "0.0.127.IN-ADDR.ARPA" {
  1393.           type master;
  1394.           file "127.0.0.zone";
  1395.   };
  1396.  
  1397.   zone "localhost" {
  1398.           type master;
  1399.           file "localhost.zone";
  1400.   };
  1401.   ______________________________________________________________________
  1402.  
  1403.   It works for everything that can go into a named.conf file, although
  1404.   it doesn't add all of the new enhancements and configuration options
  1405.   that bind8 allows.  Here's a more complete named.conf that does the
  1406.   same things, but a little more efficiently.
  1407.  
  1408.   ______________________________________________________________________
  1409.   // This is a configuration file for named (from BIND 8.1 or later).
  1410.   // It would normally be installed as /etc/named.conf.
  1411.   // The only change made from the `stock' named.conf (aside from this
  1412.   // comment :) is that the directory line was uncommented, since I
  1413.   // already had the zone files in /var/named.
  1414.  
  1415.   options {
  1416.           directory "/var/named";
  1417.           check-names master warn;                /* default. */
  1418.           datasize 20M;
  1419.   };
  1420.  
  1421.   zone "localhost" IN {
  1422.           type master;
  1423.           file "localhost.zone";
  1424.           check-names fail;
  1425.           allow-update { none; };
  1426.           allow-transfer { any; };
  1427.   };
  1428.  
  1429.   zone "0.0.127.in-addr.arpa" IN {
  1430.           type master;
  1431.           file "127.0.0.zone";
  1432.           check-names fail;
  1433.           allow-update { none; };
  1434.           allow-transfer { any; };
  1435.   };
  1436.  
  1437.   zone "." IN {
  1438.           type hint;
  1439.           file "root.hints";
  1440.   };
  1441.   ______________________________________________________________________
  1442.  
  1443.   bind8/src/bin/named/test has this, and copies of the zone files, that
  1444.   many people can just drop in and use instantly.
  1445.  
  1446.   The formats for zone files and root.hints files are identical, as are
  1447.   the commands for updating them.
  1448.  
  1449.   8.  FAQ
  1450.  
  1451.   In this section I list some of the most frequently asked questions
  1452.   related to DNS and this HOWTO.  And the answers :-) Please read this
  1453.   section before mailing me.
  1454.  
  1455.   1. My named wants a named.boot file
  1456.  
  1457.      You are reading the wrong HOWTO.  Please see the old version of
  1458.      this HOWTO, which convers bind 4, at
  1459.      http://www.math.uio.no/~janl/DNS/
  1460.  
  1461.   2. How do use DNS from inside a firewall?
  1462.  
  1463.      A couple of hints: `forwarders', `slave', and have a look in the
  1464.      literature list at the end of this HOWTO.
  1465.   3. How do I make DNS rotate through the available addresses for a
  1466.      service, say www.busy.site to obtain a load balancing effect, or
  1467.      similar?
  1468.  
  1469.      Make several A records for www.busy.site and use bind 4.9.3 or
  1470.      later.  Then bind will round-robin the answers.  It will not work
  1471.      with earlier versions of bind.
  1472.  
  1473.   4. I want to set up DNS on a (closed) intranet.  What do I do?
  1474.  
  1475.      You drop the root.hints file and just do zone files.  That also
  1476.      means you don't have to get new hint files all the time.
  1477.  
  1478.   5. How do I set up a secondary (slave) name server?
  1479.  
  1480.      If the primary server has address 127.0.0.1 you put a line like
  1481.      this in the named.conf file of your secondary:
  1482.  
  1483.      ___________________________________________________________________
  1484.        zone "linux.bogus" {
  1485.              type slave;
  1486.              file "sz/linux.bogus";
  1487.              masters { 127.0.0.1; };
  1488.        };
  1489.  
  1490.      ___________________________________________________________________
  1491.  
  1492.   You may list several alternate master servers the zone can be copied
  1493.   from inside the masters list, separated by ';' (semicolon).
  1494.  
  1495.   6. I want bind running when I'm disconnected from the net.
  1496.  
  1497.      I have received this mail from Ian Clark <ic@deakin.edu.au> where
  1498.      he explains his way of doing this:
  1499.  
  1500.   I run named on my 'Masquerading' machine here. I have
  1501.   two root.hints files, one called root.hints.real which contains
  1502.   the real root server names and the other called root.hints.fake
  1503.   which contains...
  1504.  
  1505.   ----
  1506.   ; root.hints.fake
  1507.   ; this file contains no information
  1508.   ----
  1509.  
  1510.   When I go off line I copy the root.hints.fake file to root.hints and
  1511.   restart named.
  1512.  
  1513.   When I go online I copy root.hints.real to root.hints and restart
  1514.   named.
  1515.  
  1516.   This is done from ip-down & ip-up respectively.
  1517.  
  1518.   The first time I do a query off line on a domain name named doesn't
  1519.   have details for it puts an entry like this in messages..
  1520.  
  1521.   Jan 28 20:10:11 hazchem named[10147]: No root nameserver for class IN
  1522.  
  1523.   which I can live with.
  1524.  
  1525.   It certainly seems to work for me. I can use the nameserver for
  1526.   local machines while off the 'net without the timeout delay for
  1527.   external domain names and I while on the 'net queries for external
  1528.   domains work normally
  1529.  
  1530.   7. Where does the caching name server store its cache? Is there any
  1531.      way I can control the size of the cache?
  1532.  
  1533.      The cache is completely stored in memory, it is not written to disk
  1534.      at any time.  Every time you kill named the cache is lost.  The
  1535.      cache is not controllable in any way.  named manages it according
  1536.      to some simple rules and that is it.  You cannot control the cache
  1537.      or the cache size in any way for any reason. If you want to you can
  1538.      ``fix'' this by hacking named.  This is however not recommended.
  1539.  
  1540.   8. Does named save the cache between restarts?  Can I make it save it?
  1541.  
  1542.      No, named does not save the cache when it dies.  That means that
  1543.      the cache must be built anew each time you kill and restart named.
  1544.      There is no way to make named save the cache in a file.  If you
  1545.      want you can ``fix'' this by hacking named.  This is however not
  1546.      recommended.
  1547.  
  1548.   9.  How to become a bigger time DNS admin.
  1549.  
  1550.   Documentation and tools.
  1551.  
  1552.   Real Documentation exists.  Online and in print.  The reading of
  1553.   several of these is required to make the step from small time DNS
  1554.   admin to a big time one.  In print the standard book is DNS and BIND
  1555.   by C. Liu and P. Albitz from O'Reilly & Associates, Sebastopol, CA,
  1556.   ISBN 0-937175-82-X.  I read this, it's excellent.  There is also a
  1557.   section in on DNS in TCP/IP Network Administration, by Craig Hunt from
  1558.   O'Reilly..., ISBN 0-937175-82-X.  Another must for Good DNS
  1559.   administration (or good anything for that matter) is Zen and the Art
  1560.   of Motorcycle Maintenance by Robert M. Prisig :-) Available as ISBN
  1561.   0688052304 and others.
  1562.  
  1563.   Online you will find stuff on  <http://www.dns.net/dnsrd/>,
  1564.   <http://www.isc.org/bind.html>; A FAQ, a reference manual (BOG; Bind
  1565.   Operations Guide) as well as papers and protocol definitions and DNS
  1566.   hacks (these, and most, if not all, of the rfcs mentioned below, are
  1567.   also contained in the bind distribution).  I have not read most of
  1568.   these, but then I'm not a big-time DNS admin either.  Arnt Gulbrandsen
  1569.   on the other hand has read BOG and he's ecstatic about it :-).  The
  1570.   newsgroup comp.protocols.tcp-ip.domains is about DNS.  In addition
  1571.   there are a number of RFCs about DNS, the most important are probably
  1572.   these:
  1573.  
  1574.      RFC 2052
  1575.         A. Gulbrandsen, P. Vixie, A DNS RR for specifying the location
  1576.         of services (DNS SRV), October 1996
  1577.  
  1578.      RFC 1918
  1579.         Y. Rekhter, R. Moskowitz, D. Karrenberg, G. de Groot, E. Lear,
  1580.         Address Allocation for Private Internets, 02/29/1996.
  1581.  
  1582.      RFC 1912
  1583.         D. Barr, Common DNS Operational and Configuration Errors,
  1584.         02/28/1996.
  1585.  
  1586.      RFC 1912 Errors
  1587.         B. Barr Errors in RFC 1912, this is available at
  1588.         <http://www.cis.ohio-state.edu/~barr/rfc1912-errors.html>
  1589.  
  1590.      RFC 1713
  1591.         A. Romao, Tools for DNS debugging, 11/03/1994.
  1592.  
  1593.      RFC 1712
  1594.         C. Farrell, M. Schulze, S. Pleitner, D. Baldoni, DNS Encoding of
  1595.         Geographical Location, 11/01/1994.
  1596.  
  1597.      RFC 1183
  1598.         R. Ullmann, P. Mockapetris, L. Mamakos, C. Everhart, New DNS RR
  1599.         Definitions, 10/08/1990.
  1600.  
  1601.      RFC 1035
  1602.         P. Mockapetris, Domain names - implementation and specification,
  1603.         11/01/1987.
  1604.  
  1605.      RFC 1034
  1606.         P. Mockapetris, Domain names - concepts and facilities,
  1607.         11/01/1987.
  1608.  
  1609.      RFC 1033
  1610.         M. Lottor, Domain administrators operations guide, 11/01/1987.
  1611.  
  1612.      RFC 1032
  1613.         M. Stahl, Domain administrators guide, 11/01/1987.
  1614.  
  1615.      RFC 974
  1616.         C. Partridge, Mail routing and the domain system, 01/01/1986.
  1617.  
  1618.